home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / music / edplayer_2.1 / edplayer.docs / edp2.1.intro.readme_first < prev    next >
Text File  |  1994-11-17  |  13KB  |  257 lines
  1.  
  2. ============================================================================
  3.                          EdPlayer version 2.1
  4.                              by Ed Mackey
  5. ============================================================================
  6.  
  7. All new releases and upgrades of PD/Shareware/Freeware by Ed & Al Mackey
  8. (such as EdPlayer) are uploaded FIRST to our official support BBS:
  9.      ____   __          ___  ___  _____  __   
  10.     /      /  \ |\  /| |__  |___)   |   /  \ |\ |           __________
  11.     \____  \__/ | \/ | |___ |  \    |   \__/ | \|             /   /
  12.        __\______  ___       ___  ___  __                     /   /
  13.      ____/ |     |__  |    |__  /    /  \ |\  /| |\  /|   __/___/__
  14.            |     |___ |___ |___ \___ \__/ | \/ | | \/ |
  15.            |
  16.            |    Modem: (215) 464-6775       HST: (215) 464-4461
  17.  
  18.  Supporting:    Amiga/IBM/Mac/][gs/UNIX     Storage:    670 Megabytes
  19.  Active Nodes:  9 (more coming soon)        Location:   Philadelphia, PA
  20.  Baud Rates:    3/12/24/48/96/14.4 (HST)    Graphics:   ANSI/IBM/SkyPix
  21.  
  22.  Features:      Teleconferencing            Global 'GO' Commands
  23.                 Multi-Player Games          Inter-User Chatting
  24.                 Live Conference RPG's       ANSI & Skypix Pictures
  25.                 Areas on ALL Topics         Special Over & Under 18 Bases
  26.                 Friendly Staff              Hundreds of Active Users
  27.  
  28. ============================================================================
  29.  
  30. The sysop of Somerton is Eric Parkin, a good friend of mine.  If you call
  31. his board in the evening or at night, there's a chance you might meet me
  32. or Al (or both) messing around in the live teleconference area.  Such fun
  33. it is to have a BBS that understands multitasking, and has so many phone
  34. lines going into it.  It's running on an Amiga with a 25MHz '030.
  35. But enough about that...  You came here to read about EdPlayer...
  36.  
  37. ----------------------------------------------------------------------------
  38.  
  39. ORGANIZATION OF THESE FILES:
  40.     These docs are organized so that you don't have to read all of them at
  41. once, but can skip to the part you want or need.  Aren't you glad??
  42. As of v2.0, I have split the DOCs into separate files:
  43.  
  44. EdP2.1.Intro.README_FIRST
  45.     -- This file.  Please read!!  Then you can fiddle with the buttons.
  46. EdP2.1.Buttons.DOC
  47.     -- After you fiddled, read this if you don't "get it".
  48. EdP2.1.LEDs.DOC
  49.     -- What all the blinking things mean.
  50. EdP2.1.Commands.DOC
  51.     -- Another way of controlling EdP.  ARexx is OPTIONAL!
  52. EdP2.1.ErrorCodes.DOC
  53.     -- Errors and POSSIBLE CAUSES!  Read if/when you get one.
  54.  
  55. NOVICE AMIGA USERS:  Don't be scared by the "ARexx" section!!  You don't
  56. need to know anything about ARexx itself to use EdPlayer commands, in
  57. fact, you don't even NEED ARexx (although it's recommended).  Please
  58. glance at this section.  There are many useful commands, and a lot of
  59. EdPlayer's functions that are too complicated for a simple point-and-click
  60. panel are stored here.
  61.  
  62. ============================================================================
  63.  
  64.                           I N T R O D U C T I O N
  65.  
  66. ============================================================================
  67.  
  68. Hello, and welcome to EdPlayer!!
  69.  
  70. First, distribution:  EdPlayer is shareware.  You can distribute it by any
  71. means, including BBSs, PD disks, and FTP services like AB20, etc.  You can
  72. also distribute EdPlayer with your own programs, as long as you include a
  73. note that EdPlayer is freely distributable, and do not make any copyright
  74. claims on EdPlayer.  If you want to distribute EdPlayer with a commercial
  75. package, please contact me first (address at end of document).  I would
  76. LIKE for you to keep these docs with EdPlayer whenever possible, because
  77. many important things are explained here (like EdPlayer's ARexx interface)
  78. that aren't explained anywhere else.  However, if you MUST distribute
  79. EdPlayer without this file, you may.  Also, note that if you distribute the
  80. kd_freq.library, you MUST keep its DOC file with it.  This is explained
  81. later in this file, in the "Buttons" section under "OPEN", the only button
  82. that uses the kd_freq.library.
  83.  
  84. The new EdPlayer Junior has the same distribution terms as EdPlayer.
  85.  
  86.            EdPlayer and EdPlayerJr are copyright 1992 Ed Mackey.
  87. ----------------------------------------------------------------------------
  88.  
  89. BUT, what IS it??
  90.  
  91. EdPlayer is a music player.  It can play both NoiseTracker modules and
  92. MED version 3.21 (or greater??) modules.  Note that SOME MED 3.00 modules
  93. will work also, however, others will show up as "Unknown or corrupt module"
  94. because MED 3.00 had a serious bug in the module-saving routines (it didn't
  95. word-align the chunks sometimes, and caused other MED players to GURU, but
  96. EdPlayer has a check for this and will only report a "corrupt module"
  97. error).  To fix a MED 3.00 or earlier module, simply load it into MED 3.21
  98. and save it back out as a MODULE.  As far as #?Tracker modules go, I
  99. am now using the ProTracker 1.1b replay routine by Lars "Zap" Hamre/Amiga
  100. Freelancers 1991.  This may make some old NT mods not work properly
  101. anymore, but I think that PT mods are far more popular by now.
  102.  
  103. What EdPlayer can be used for:
  104.  
  105. I had MANY uses in mind as I was designing EdPlayer.  I wanted a music
  106. player that could be used directly for entertainment, or multitask while
  107. the user did word-processing or whatever, and also be able to run from both
  108. ARexx and CLI scripts for use in IFF slide shows, presentations with
  109. background music (AmigaVision, DVideo III, Director 2, etc.), music for
  110. games written in AmigaBasic or other languages for which there are no
  111. music-playing routines available, and basically any situation at all where
  112. someone wants their Amiga to play some tunes.   ;->
  113.  
  114. EdPlayerJr is a small version of EdPlayer, one that has no main panel.
  115. It can be controlled from ARexx, telled, cteled, etc.  It is very
  116. good in low-mem conditions, because it only takes a few bytes of
  117. CHIP mem, leaving most of the memory free for mods.  It is also good
  118. for presentations that don't need the main panel, etc.  You can even
  119. create programs (lists of songs) in the main EdPlayer and play them
  120. back with EdPlayerJr.
  121.  
  122. EdPlayerJr tries to be as compatible as possible with the main EdPlayer
  123. except for the lack of the panel.  Almost all the same ARexx commands
  124. work, the same startup script is used, etc.  Even the version numbers
  125. are the same so you can keep matching versions of EdPlayer and
  126. EdPlayerJr together.
  127.  
  128. ----------------------------------------------------------------------------
  129. Starting EdPlayer:  There are four ways to start EdPlayer...
  130.  ---> (1) Workbench Icon.        Brings up some CD-player like controls.
  131.       (2) CLI: "run EdPlayer"    Also brings up the CD controls.
  132.       (3) CLI: "run EdPlayer -i" Brings up a tiny "iconified" WB window.
  133.       (4) CLI: "run EdPlayer -h" NO user interface, ARexx port ONLY!
  134.  
  135. Note that I recommend using the "runback" command rather than "run" if you
  136. have it, so that the CLI window itself can close before EdPlayer does.
  137. NOTE: A simmilar effect can be achieved with "run <NIL: >NIL: EdPlayer".
  138.  
  139. Note that ALL 4 startup methods open the EDPLAYER message port, which can
  140. accept instructions from AREXX (if you have it) as well as the "telled"
  141. command explained in the ARexx section.
  142.  
  143.              *************** STARTUP SCRIPTS *****************
  144.  
  145. As of version 2.0, EdPlayer now attempts to run a startup script IF
  146. ARexx is present when EdP is launched.  The startup script should be
  147. called REXX:Startup.EdP.  An example startup script is contained in
  148. this archive; please modify that to your liking rather than attempting
  149. to create one from scratch.  If you create one from scratch you might
  150. forget some features or something, whereas the provided startup shows
  151. how to set everything.  Of course, if you know all the ARexx commands,
  152. feel free to make one from scratch.
  153.  
  154. Please don't distribute modified startups.
  155. ----------------------------------------------------------------------------
  156.  
  157. OK, now that you know how to run it, you can start playing with it even
  158. before you finish reading these DOCs.  This is because there is an ONLINE
  159. HELP FUNCTION that is sel